home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Mac Game Programming Gurus / TricksOfTheMacGameProgrammingGurus.iso / More Source / C⁄C++ / Xconq 7.0d37 / source / mac / README.mac < prev    next >
Encoding:
Text File  |  1995-05-05  |  2.7 KB  |  138 lines  |  [TEXT/R*ch]

  1. This is the Mac source directory for Xconq.
  2.  
  3. The instructions here are for building from source.  It is assumed that you have already either transferred the sources to a Mac or made a shared volume visible to one, and that you have moved and unpacked certain binary files; read and follow the instructions in "DO_FIRST.mac" in order to do this.
  4.  
  5. SYSTEM REQUIREMENTS
  6.  
  7. Sorry, but 4M RAM under System 7 is not enough to compile all the files - Think C runs out of memory for what appears to be obscure reasons.  8M RAM is enough to build, run, and debug Xconq, plus have ResEdit open as well.
  8.  
  9. Decide which development system to use.
  10.  
  11. BUILDING
  12.  
  13. For Think C, just select "Build Application" from the menu.
  14.  
  15. For MPW, build "xconq".
  16.  
  17. INSTALLING
  18.  
  19. No installation process is necessary.
  20.  
  21. If you want to move the executable elsewhere, you must also bring along "lib" and "lib-mac", and put them in the same folder as the application.
  22.  
  23. [how to make readable docs]
  24.  
  25.  
  26. Road Map to the Sources
  27.  
  28. Skelconq:
  29.  
  30. Skelconq is a game testing and compilation application that uses console I/O only.
  31.  
  32. IMFApp:
  33.  
  34. IMFApp is a utility for examining and converting the image families used by Xconq.
  35.  
  36. Files and Folders:
  37.  
  38. Generic sources are in "kernel", Mac-specific code in "mac".  Xconq uses all files in "mac" and "kernel" except for "skelconq.c", "cmdline.c", "compile.c", and OS-specific files, while Skelconq uses everything in "kernel" except OS-specific files and nothing in "mac".
  39.  
  40. Generic test cases and (Unix-based) test machinery are in "test".
  41.  
  42. Documentation in TeX (texinfo) is in "doc".
  43.  
  44. Game translation tools and suchlike are in "misc".  These are all Unix-based.
  45.  
  46. Sources to the other Xconq interfaces, if present, are in folders like "curses", "x11", and so forth.  Unix configuration info is in "config*" files and the "config" directory.
  47.  
  48. Note that "kernel", "lib", "test", "doc", and "misc" are identical on all systems, so don't put anything in them (such as binary files) that can't be included everywhere.  Since "mac" is a source directory, it should not have binary or resource files either. Use "lib-mac", "doc-mac", and "build-mac" for Mac-only files.
  49.  
  50. Think C project description
  51.  
  52. Files and Segments:
  53.  
  54. mac.c
  55. macconq.c
  56. version.c
  57.  
  58. macmap.c
  59.  
  60. macdraw.c
  61. macimf.c
  62. macmap2.c
  63. MacTraps
  64. MacTraps2
  65.  
  66. maccmd.c
  67. macmenus.c
  68. macwins.c
  69.  
  70. maclist.c
  71.  
  72. macdesign.c
  73.  
  74. macinit.c
  75.  
  76. help.c
  77. nlang.c
  78.  
  79. write.c
  80.  
  81. imf.c
  82. ui.c
  83.  
  84. history.c
  85. lisp.c
  86. mknames.c
  87. score.c
  88. util.c
  89.  
  90. side.c
  91. unit.c
  92. world.c
  93.  
  94. plan.c
  95. task.c
  96.  
  97. run.c
  98.  
  99. actions.c
  100.  
  101. combat.c
  102.  
  103. ai.c
  104. mplay.c
  105.  
  106. module.c
  107. read.c
  108.  
  109. tables.c
  110.  
  111. init.c
  112. mkrivers.c
  113. mkroads.c
  114. mkterr.c
  115. mkunits.c
  116.  
  117. ANSI-32
  118.  
  119. generic.c
  120. types.c
  121.  
  122.  
  123. ps.c
  124.  
  125. Prefix:
  126.  
  127. #include <MacHeaders>
  128.  
  129. #define MAC
  130.  
  131. Think C Options:
  132.  
  133. strict prototype enforcement, require prototypes
  134. set 4-byte ints
  135. enums are always ints
  136.  
  137.  
  138.